Your suggested change has been received. Thank you.

close

OpenAPI specification for the Luna Crypto Command Center (CCC) (1.0.0)

Download OpenAPI specification:Download

The CCC REST API provides Web-based application with a lightweight mean to communicate with the CCC server.

See also:

> REST API for Crypto Command Center (latest version)

Authentication

Get an OpenID Connect bearer token

Get an OpenID Connect bearer token using a password authentication.

Authorizations:
bearerAuthentication
header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json
Request Body schema: application/x-www-form-urlencoded

Authentication data required to get an OpenID Connect bearer token.

grant_type
required
string
Default: "password"
Value: "password"

The only supported value in this REST API version is 'password'.

client_id
required
string
Default: "ccc-cli"
Value: "ccc-cli"

The only supported value in this REST API version is 'ccc-cli'.

username
required
string <string> (cccUsername) [ 3 .. 132 ] characters [a-zA-Z0-9][!#$%@\'()*+,\-.\/0-9:=@A-Z\[\]\^_...

A CCC admin/application owner username.

password
required
string <string> (cccUserPassword) [ 8 .. 132 ] characters [a-zA-Z0-9!#$%&()*+,.\/:<=>?@[\]^_{|}~";-]+

A CCC admin/application owner password.

Responses

Response samples

Content type
application/json
{
  • "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
  • "token_type": "Bearer",
  • "expires_in": 1,
  • "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"
}

Devices

Get the list of devices

Get the list of devices (authorized and unauthorized).

Authorizations:
bearerAuthentication
header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/vnd.safenetinc.lunacloud.v1+json/json
"{\n 'resource':\n [\n {\n 'id': 1\n 'name': 'device-1'\n 'description': 'Device 1'\n 'type': 'application/vnd.safenetinc.lunacloud.v1.adminmonitoringdevice+json'\n 'href': '/api/admin/monitoring/devices/1'\n 'rel': 'monitoring/devices'\n }\n ]\n}\n"

Get information on a service

Get general information on a service running on a device.

Authorizations:
bearerAuthentication
path Parameters
deviceId
required
integer <int32> (deviceId) [ 0 .. 9999 ]

A unique CCC device identifier.

serviceType
required
string (serviceType)
Default: "ntls"
Enum: "cbs" "lsta" "network" "ntls" "ntp" "syslog" "snmp" "ssh" "stc" "sysstat" "webserver"

A type of service.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
{
  • "status": "running"
}

Services

Get the list of services

Get the list of services.

Authorizations:
bearerAuthentication
header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/vnd.safenetinc.lunacloud.v1+json
{
  • "resource": [
    ]
}

Get storage information about a service

Get the storage spaces allocated to a service.

Authorizations:
bearerAuthentication
path Parameters
serviceId
required
integer <int32> (cccServiceId) [ 0 .. 9999 ]
Default: 0

A CCC service identifier.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
[
  • "{\n 'free': '78148',\n 'total': '80000',\n 'used': '1852',\n 'label': 'New_Ser',\n 'objectCount': '2',\n 'name': 'New_Ser',\n 'state': 'initialized',\n 'version': '1',\n 'soChangePasswordAttemptsLeft': '10'\n}\n"
]

Monitoring/Devices

Get the list of devices enabled for monitoring

Get the list of devices (authorized and unauthorized) that are enabled for monitoring.

Authorizations:
bearerAuthentication
header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/vnd.safenetinc.lunacloud.v1+json/json
"{\n 'resource':\n [\n {\n 'id': 1\n 'name': 'device-1'\n 'description': 'Device 1'\n 'type': 'application/vnd.safenetinc.lunacloud.v1.adminmonitoringdevice+json'\n 'href': '/api/admin/monitoring/devices/1'\n 'rel': 'monitoring/devices'\n }\n ]\n}\n"

Get the connection status of all the monitored devices

Get a list of connection statuses for the devices that are enabled for monitoring.

Authorizations:
bearerAuthentication
header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/vnd.safenetinc.lunacloud.v1+json
[
  • "{\n 'id': 1,\n 'name': 'device-1'\n 'description': 'Device 1'\n 'type': 'application/vnd.safenetinc.lunacloud.v1.adminmonitoringdevice+json'\n 'href': '/api/admin/monitoring/devices/1'\n 'rel': 'monitoring/devices'\n}\n"
]

Get the monitoring attributes of a monitored device

Get the monitoring attributes of a device that is enabled for monitoring.

Authorizations:
bearerAuthentication
path Parameters
deviceId
required
integer <int32> (deviceId) [ 0 .. 9999 ]

A unique CCC device identifier.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
"{\n 'id': 1\n 'name': 'device-1'\n 'description': 'Device 1'\n 'type': 'application/vnd.safenetinc.lunacloud.v1.adminmonitoringdevice+json'\n 'href': /api/admin/monitoring/devices/1\n 'counters': {\n 'monitoringData': [\n {\n 'type': 'application/vnd.safenetinc.lunacloud.v1.admincounters+json'\n 'href': /api/admin/monitoring/devices/1/counters\n 'rel': 'counters'\n }\n ]\n },\n 'sensors': {\n 'monitoringData': [\n {\n 'type': 'application/vnd.safenetinc.lunacloud.v1.adminsensors+json'\n 'href': /api/admin/monitoring/devices/1/sensors\n 'rel': 'sensors'\n }\n ]\n },\n 'info': {\n 'monitoringData': [\n {\n 'type': 'application/vnd.safenetinc.lunacloud.v1.admininfo+json'\n 'href': /api/admin/monitoring/devices/1/info\n 'rel': 'info'\n }\n ]\n},\n 'performance': {\n 'monitoringData': [\n {\n 'type': 'application/vnd.safenetinc.lunacloud.v1.adminperformance+json'\n 'href': /api/admin/monitoring/devices/1/performance\n 'rel': 'performance'\n }\n ]\n },\n 'nextRunTime': 1726212060007\n 'taskStartTime': 1726212000007\n 'taskEndTime': 1726212046455\n}\n"

Get the connection status of a monitored device

Get the connection status a device that is enabled for monitoring.

Authorizations:
bearerAuthentication
path Parameters
deviceId
required
integer <int32> (deviceId) [ 0 .. 9999 ]

A unique CCC device identifier.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
"{\n 'id': 1\n 'name': 'device-1'\n 'description': 'Device 1'\n 'type': 'application/vnd.safenetinc.lunacloud.v1.adminmonitoringdevice+json'\n 'href': '/api/admin/monitoring/devices/1'\n 'rel': 'monitoring/devices'\n}\n"

Get the counters of a monitored device

Get a list of counters for a device that is enabled for monitoring.

Authorizations:
bearerAuthentication
path Parameters
deviceId
required
integer <int32> (deviceId) [ 0 .. 9999 ]

A unique CCC device identifier.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
{
  • "lastUpdateTime": 0,
  • "data": [
    ]
}

Get information on a monitored device

Get information on a device that is enabled for monitoring.

Authorizations:
bearerAuthentication
path Parameters
deviceId
required
integer <int32> (deviceId) [ 0 .. 9999 ]

A unique CCC device identifier.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
{
  • "lastUpdateTime": 0,
  • "data": [
    ]
}

Get the performance values of a monitored device

Get a list of performance values for a device that is enabled for monitoring.

Authorizations:
bearerAuthentication
path Parameters
deviceId
required
integer <int32> (deviceId) [ 0 .. 9999 ]

A unique CCC device identifier.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
{
  • "lastUpdateTime": 0,
  • "data": [
    ]
}

Get the sensors of a monitored device

Get a list of sensors for a device that is enabled for monitoring.

Authorizations:
bearerAuthentication
path Parameters
deviceId
required
integer <int32> (deviceId) [ 0 .. 9999 ]

A unique CCC device identifier.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
{
  • "lastUpdateTime": 0,
  • "data": [
    ]
}

Monitoring/Services

Get the average operation per seconds for a service

Get the average operation per seconds for a service as a map.

Authorizations:
bearerAuthentication
header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
"{\n '1': '0',\n '2': '0',\n '3': '0',\n '4': '0',\n '103': '1',\n '104': '0',\n '5': '------',\n '6': '------',\n '51': '------'\n}\n"

Get client monitoring information for a service

Get client monitoring information for a service.

Authorizations:
bearerAuthentication
path Parameters
serviceId
required
integer <int32> (cccServiceId) [ 0 .. 9999 ]
Default: 0

A CCC service identifier.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
[
  • "{\n 'connectionType': 'NTLS',\n 'deviceAddress': '192.168.168.100',\n 'clientAddress': '192.168.168.200',\n 'state': 'CLOSED',\n 'protocol': '----',\n 'connectedPartition': 'partition-1'\n}\n"
]

Get PUM for a service and a partition as a doughnut

Get PUM (Performance Utilization Metrics) for a service and a partition as a doughnut.

Authorizations:
bearerAuthentication
path Parameters
serviceId
required
integer <int32> (cccServiceId) [ 0 .. 9999 ]
Default: 0

A CCC service identifier.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
"{\n 'DECRYPT': '0',\n 'ALL_OPERATIONS': '4',\n 'KEY_DERIVATION': '0',\n 'PUM_POLICY_STATUS': 'true',\n 'KEY_GENERATION': '4',\n 'VERIFY': '0',\n 'ENCRYPT': '0',\n 'SIGN': '0'\n}\n"

Get PUM for a service and a partition as a line chart

Get PUM (Performance Utilization Metrics) for a service and a partition as a line chart.

Authorizations:
bearerAuthentication
path Parameters
serviceId
required
integer <int32> (cccServiceId) [ 0 .. 9999 ]
Default: 0

A CCC service identifier.

query Parameters
elemId
integer <int32> (cccServiceId) [ 0 .. 9999 ]
Default: 0

A CCC service identifier.

operationId
string
Default: "All_Operations"
Value: "All_Operations"
per
string
Default: "SECONDS"
Value: "SECOND"
startTime
integer <int64> (timestamp) >= 0

A timestamp in Epoch.

endTime
integer <int64> (timestamp) >= 0

A timestamp in Epoch.

timeLabel
string
Default: "lastHour"
Value: "lastHour"
header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
"[\n {\n 'idServElement': 0,\n 'lastUpdateTime': 1726891199857,\n 'data': \n [\n {\n 'name': 'Operations/Sec',\n 'value': '0'\n }\n {\n 'name': 'Avg Operations/Sec',\n 'value': '0'\n },\n {\n 'name': 'operationId',\n 'value': 'ALL_OPERATIONS'\n }\n ]\n }\n]\n"

Get PUM policy status for a service element

Get PUM (Performance Utilization Metrics) policy status for a service element.

Authorizations:
bearerAuthentication
path Parameters
serviceId
required
integer <int32> (cccServiceId) [ 0 .. 9999 ]
Default: 0

A CCC service identifier.

serviceElementId
required
integer <int32> (serviceElementId) [ 0 .. 9999 ]
Default: 0

A CCC service element identifier.

header Parameters
Content-Type
required
string
Example: application/vnd.safenetinc.lunacloud.v1+json

Responses

Response samples

Content type
application/json
{
  • "LAST_METRICS_RECORD_TIMESTAMP": 0,
  • "PUM_POLICY_STATUS": true,
  • "METRICS_COUNTER_RESET_TIME": 0
}